Notifications > Notifications Overview > Notification Address Types > SMTP Mail Messages

SMTP Mail Messages

For SMTP notifications the GNS must be configured with the SMTP host information. Keywords in the configuration file specify SMTP and email parameters. The GNS Configuration Tester utility (GNSConfig.exe) is provided for setting up this section of the configuration file so that the user name and password can be encrypted. See GNS Configuration Tester Utility for more information.

GNS Configuration File Keywords

The keywords that must be configured to enable SMTP mail message notifications are in two locations in the Gns.cfg.

See the SMTP Mail Keywords for more information.

Keyword Description

SMTP_HOST

The SMTP server host name or IP address.

SMTP_PORT

The port number used by the SMTP server. Usually port 25.

SMTP_RECEIVE_TIMEOUT

Specifies the maximum amount of time (in seconds) the GNS service will wait for a response from the SMTP server.

SMTP_TLS_METHOD

The encryption method used for outgoing email notifications. Options include: NONE, SSL/TLS, or STARTTLS. While the General Notification Service (GNS) supports SMTP encryption, it cannot be configured or tested with the GNS Configuration Tester utility (GnsConfig.exe).

See the Shared Mail Settings Keywords for more information.

Keyword Description

EMAIL_ADDRESS

The return (from) address for acknowledgment reply emails, such as name@company.com. The return address for all SMTP mail messages.

EMAIL_USERNAME

The username for the email server, if required. This value is shared by both the POP3 and SMTP email servers. It is required for the Incoming POP3 Server (for receiving acknowledgment reply emails) and optional for the outgoing SMTP Server (for sending SMTP mail messages). The username is encrypted with the common encryption key file.

EMAIL_PASSWORD

The user password for the email server, if required. This value is shared by both the POP3 and SMTP email servers. It is required for the Incoming POP3 Server (for receiving acknowledgment reply emails) and optional for the outgoing SMTP Server (for sending SMTP mail messages). The password is encrypted with the common encryption key file. The password for the email server cannot be decrypted, as it is only ever compared against.

SANDBOX_EMAIL_HANDLING

Allows a user to opt out of sandboxing for the SMTP email handler.

See Acknowledging Notifications for information about how to acknowledge a notification by a reply email.


Let us know how we can improve this topic.

CygNet at weatherford.com

© 2020 Weatherford. All rights reserved.